home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / pmlpp140.zip / README < prev   
Text File  |  1997-08-14  |  5KB  |  119 lines
  1. "Little Pop Peek for PM" (PMLPP)
  2.  
  3. A historical (hysterical?) note: I threw this together after
  4. becoming quite frustrated with a couple of the other alternatives
  5. available. While the others looked nice, the only two that were
  6. really small/fast "applets" refused to talk to both my local pop3
  7. server (PowerWeb++) or my ISP's (some *nix variant on DEC hardware).
  8. At least one author in his readme mentioned looking for a "hello"
  9. string or somesuch - I suggest he go back and look at the RFC's and
  10. actually read the pop3 spec next time instead of just peeking at the
  11. examples. Anyway, this one's probably got bugs too, but at least
  12. they're different that the other guys; i.e., this one works where
  13. theirs didn't AFAIK, the reverse is true :-) The big difference is
  14. that if mine doesn't work for you, *YOU* (not me... what do you
  15. expect for free? :) have the source and can fix it.
  16.  
  17. Installation:
  18.  
  19.    Copy pmlpp.exe and pmlpp.hlp to any convenient directory and run
  20.    it. A configuration dialog will come up automatically the first
  21.    time you run it. Context-sensitive help is available. You can
  22.    access the config dialog at any time by popping up the
  23.    system/context menu (usually a mouse-button-2 over the app window).
  24.    
  25. This software is "Copyleft'ed" (GNU general license) and includes 'C'
  26. source code. The included executable was compiled with Watcom C 11.0,
  27. optimized with LXOPT and compressed. The makefile is for Watcom, but
  28. everything should be trivial and generic enough to easily recompile
  29. it with VAC++ or Borland (I've done it with the former, Watcom's
  30. EXE was about 11K smaller :-). 
  31.  
  32. NOTE: PMLPP keeps all of its configuration in PMLPP.INI, which it
  33. places and looks-for in the same directory as the executable. It
  34. looks for PMLPP.HLP (its "help" file) in the same place. So, if you
  35. move the executable, move pmlpp.hlp and pmlpp.ini also, or things
  36. won't work right :-)
  37.  
  38. Changes in version 1.10:
  39. -----------------------
  40.  
  41. To upgrade, simply copy pmlpp.exe over your old version.
  42.  
  43. 1) Added APOP support.
  44. 2) Added option to save/not-save the password.
  45. 3) If you try to start a second copy of PMLPP, it will now bring the
  46. running copy to the foreground rather than beeping and bitching that
  47. a copy is already running.
  48. 4) Some code cleanup out of personal pride... no bugs reported or
  49. found, hence, nothing has been "fixed."
  50.  
  51. Changes in version 1.20: ( not released publically )
  52. -----------------------
  53.  
  54. Upgrade as above - READ NOTE #1 below!
  55.                    ^^^^^^^^^^^^^^^^^^
  56.  
  57. 1) Changed polling interval granularity from minutes to SECONDS! I don't
  58.    know why anyone would want this, but the change was asked for by
  59.    enough people to warrant it. The valid range is now 1 .. 86400. If 
  60.    you set it up to poll every 2 seconds and things "break," don't come
  61.    crying to me :-)
  62.  
  63. 2) Found and fixed some potential problems with the pop routines - I've
  64.    reverted to the "KISS" principle and have cut out some fancy and 
  65.    unneccesary baggage. 
  66.  
  67. 3) Added a visual indication that a poll command is really being executed.
  68.    If you manually force a refresh, the message count window will show
  69.    "--" until the poll completes/returns.
  70.  
  71. 4) There is some limited debugging/logging code in the pop.c module. 
  72.    If you "#define DEBUG" in pop.c and recompile, the EXE will
  73.    write specific socket errors and such to whatever you have defined
  74.    as your syslog. Of course, you must have syslogd running :-)
  75.  
  76. Changes in version 1.21:
  77. -----------------------
  78.  
  79. 1) Double-clicking either mouse button over the main window will launch
  80.    your mail reader.
  81.    
  82. Changes in version 1.22:
  83. -----------------------   
  84.  
  85. 1) Added code to IGNORE a DNS lookup failure on an IP address. In
  86.    other words, if you use an IP address rather than a host/domain
  87.    name for the pop server, make sure it's typed in correctly, as
  88.    PMLPP will attempt to use it even if it can't confirm that said
  89.    address exists by doing a DNS/HOSTS-file lookup. This allows you
  90.    to "force" PMLPP to connect to a specific machine, bypassing
  91.    DNS.
  92.    
  93. Changes in version 1.30:
  94. -----------------------
  95.  
  96. 1) Somewhere along the line I trashed the "Play Sound" and "Save
  97.    Password" toggles - neither one was behaving as advertised.
  98.    Fixed.
  99.    
  100. 2) Added a small dialog that prompts for the password on startup
  101.    if it wasn't saved in the config file - much friendlier than
  102.    popping up the entire configuration dialog :-)
  103.    
  104. Changes in version 1.40:
  105. -----------------------
  106.  
  107. 1) Changed the "refresh" button to serve a dual purpose: If you've
  108.    defined a mailreader, AND there is new mail available, clicking
  109.    on the button will launch your mail reader; Otherwise, it
  110.    reverts to the old behavior of polling the server. The "refresh"
  111.    menu item still works as before and will only cause a refresh.
  112.    
  113.    Thanks to Olexander Lebid for the idea.
  114.    
  115. Enjoy,
  116.  
  117. Jim Louvau
  118. jim@vwm.com
  119.